package com.gitee.helioz.openai.api.endpoint.audio;

import com.gitee.helioz.openai.api.dto.audio.TranscriptionsRequest;
import com.gitee.helioz.openai.api.dto.audio.TranscriptionsResponse;
import com.gitee.helioz.openai.api.dto.audio.TranslationsRequest;

/**
 * 〈音频服务〉
 *
 * @author <a href="https://gitee.com/helioz">Morning Starr</a>
 */
public interface AudioService {

    /**
     * 将音频文件转录为文本
     * <p>
     * <a href="https://platform.openai.com/docs/api-reference/audio">文档</a>
     *
     * @param transRequest 请求对象
     * @return 响应对象
     */
    TranscriptionsResponse transcriptions(TranscriptionsRequest transRequest);

    /**
     * 将音频翻译成英语
     * <p>
     * <a href="https://platform.openai.com/docs/api-reference/audio">文档</a>
     *
     * @param transRequest 请求对象
     * @return 响应对象
     */
    TranscriptionsResponse translations(TranslationsRequest transRequest);
}
